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MAT History File 


The MAT History File receives input from other MAT components and stores 
it in a special database for later retrieval. Capabilities are provided to archive, 
purge, and prepare reports of log file contents. This information is useful for 
system monitoring, diagnostics, and troubleshooting. 


Each MAT component provides a method for activating the log function. For 
example, the Scheduler includes Log Events as a menu selection. Toggling 
this selection turns the log function on and off. 


During initial system operation or during troubleshooting, it is advisable to 
activate history file logging from most or all modules. However, this causes 
additional system overhead and rapid growth of the log file. Therefore, during 
normal operation, using this facility to greatest advantage requires careful 
selection of which information to log by which modules. 


Accessing the MAT History File 


To access the MAT History File, double-click on the MAT History File icon. 
The MAT History File window appears. The window lists the logged events 
of your current session only. A session begins when you initialize the MAT 
system. 


The MAT History File window provides access to the following capabilities: 
— Browse 

— Reports 

— Maintenance 


— Options 
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Figure 39 
MAT History File window 
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Browse 


Browse presents the entire contents of the MAT History File database, 
beginning when logging was initiated or after the latest file purge. To view 
these entries, select Browse—the Browse window appears. 


Figure 40 
Browse window 
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The following is a description of the fields that appear in the Browse window 
for a MAT History File record: 


Log Number: This field contains a unique identifier. The number, up to 10 
characters in length, has two parts separated by a decimal: the generation 
number and the sequence number. The generation number identifies a 
restarting of the MAT History File. The number is automatically incremented 
each time the MAT History File is initialized (when MAT is restarted from 
the Startup window). The sequence number identifies a specific entry within 
the current generation of the log. 


A module sending a log request to the MAT History File has the option of 
sending a sequence number. The MAT History File uses this non-zero value. 
If the sequence number sent is zero, the MAT History File assigns the 
sequence number. The combination of the generation number and the 
sequence number forms a unique identifier for each log entry. The MAT 
History File returns the sequence number to the sending module as well as to 
other modules that are making log entries. 


Source: This 8-character field lists the name of the module or component 
sending the log entry. The following is a list of available sources that register 
activity messages in the MAT History file. 


MATAdmin MAT Site/User Configuration 
MATShell MAT Program Group 

MATDLL Background MAT Dynamic Link Library 
MATTerm MAT Terminal Emulation 

CLF MAT History File 

Schedulr Scheduler 

Queue Queue Manager 

ComSup Communications Supervisor 
ComSer Communications Server 
LICEDIT License Editor 

MATVT220 MAT VT220 Terminal Emulation 
TAM Traffic Analysis Module 
TCOLLECT Traffic Collection and Parsing 
TAMAE TAM Analytical Engine 

FLEDIT TAM Filter Editor 

PROEDIT TAM Profile Editor 

DBMAINT TAM Database Maintenance 
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Date: This field contains the date (in MM/DD/YY format) when the message 
was logged. 


Time: This field contains the time (in 24-hour hh:mm:ss format) when the 
message was logged. 


Severity: This field contains the severity of the entry being logged. It is used 
for diagnostic purposes. 


0 Information 

1 Warning 

2 Error 

3 Fatal 

4 Unclassified (message itself with no severity association) 


Message: This field contains a message from the source module describing 
the event that was logged (e.g. user login). 


The Filter menu 


A filter provides record selection criteria that define the subset of information 
to be displayed or printed. These criteria include dates, times, log numbers, 
and source module names. 


Filter files are named SELECTxx.DAT, where xx is a meaningful one- or 
two-character identifier. The default file names for filter files are: 


SELECTF.DAT Browse/reports filters 
SELECTP.DAT Purge filters 
SELECTB.DAT Backup filters 
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Select 
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Choose Select from the Filter menu of the Browser window to access a filter. 
The Filter dialog appears. 


Figure 41 
Filter dialog 
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In the Filter window, enter information in the following fields to define a 
filter: 


Filter Description: Type in a description for this filter. 


Date Filter: Enter one or more date ranges in the Date From and To fields. 
Use MM/DD format, and click on Include or Exclude to indicate whether log 
entries within the specified range are to be included in or excluded from the 
filtered output. 


Time Filter: Enter one or more time ranges in the Time From and To fields. 
Use hh:mm format, and click on Include or Exclude to indicate whether log 
entries within the specified range are to be included in or excluded from the 
filtered output. 


Source Filter: Enter one or more module names in the Source fields. These 


are the modules whose entries are to be included in or excluded from the 
filtered output. 
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Log Numbers Filter: Enter the MAT History File number range in the Log 
Numbers From and To fields. (The MAT History File assigns a number to 
each entry it logs.) You have the option to enter the generation and sequence 
numbers or the generation number alone, and click on Include or Exclude to 
indicate whether log entries within the specified range are to be included in 
or excluded from the filtered output. 


Severity Filter: Enter the severity range in the Severity From and To fields, 
then click on Include or Exclude to indicate whether log entries within the 
specified range are to be included in or excluded from the filtered output. 


Select Save from the Filter menu to save this filter. Select Close from the File 
menu to return to the Browse window. The only entries that appear are those 
meeting your selection criteria. 


Select Save As from the File menu to save this filter to save to a filename 
other than the default. 


Click on Open to open a filtered file other than the default. 


Reset 


Click on Reset in the Filter menu to reset filters to include all records. 


Options 
The following selections are available from the Options menu of the Browse 


window: 


Status 


To view last generation and sequence number in the MAT History File, click 
on Status. The generation number is the number of times the MAT system 
has been run since it was installed. The sequence is the number of the most 
recent activity in the current session logged to the MAT History file. 


Info 


To view the position of the current highlighted record among the total number 
of records stored in the MAT History File Database, click on Info. 


Close 


To close the Browse Control menu, click on Close. 
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Reports 
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The MAT History File window includes a Reports menu. Open this menu and 
select Print Report to print the contents of the MAT History File database. 
The standard Printer dialog appears, prompting for printer information. 


Note: The report format is 132 characters wide. A list of appropriate 
fonts is offered in the printer setup dialog. If your printer does not have 
a suitable font, it will be unable to print correctly. If you choose the 
Generic printer, you must designate the 17 CPI font set up in the 
Windows Control Panel. From the Control Panel, select Printers - Setup 
- Modify and update the printer information. Please see the Windows 
User's Guide for additional information on font settings. 


If you want to tailor your reports, you can use filters as you did during 
Browse. To access the Filters window, select Set Filters from the Reports 
menu. Refer to “The Filter menu” on page 138 for instructions on using 
filters. 


To reset filters so that reports include all MAT History File database 
information, select Reset Filters in the Reports menu. 


Maintenance 


Purge 


The Maintenance menu of the MAT History File window provides you with 
functions to purge (erase) or archive (save) the contents of its database. 


To remove data from the MAT History File Database, select Purge from the 
Maintenance menu. The Filter dialog appears, prompting you to define the 
data you wish to purge. Refer to “The Filter menu” on page 138 for 
instructions on how to use filters. 


After you have entered filter information and closed the Filter window, MAT 
warns you that filtered records will be deleted. Click on OK to continue. Click 
on Cancel to exit without purging the data. If you click on OK, MAT asks for 
another confirmation. Again, click on OK to purge the database, Cancel to 
exit the purge procedure. 
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MAT History File 


Archive 


Options 


Status 


To archive the records of the database, select Archive in the Maintenance 
menu. 


The Filter dialog appears, prompting you to enter the filter name and the filter 
range. To exclude a range from being backed up, click on the Exclude instead 
of Include. Close the dialog. See “The Filter menu” on page 138 for more 
information on choosing filters. 


The Options menu of the MAT History File window provides the following 
options: 


To view current information on the operation of the MAT History File, select 
Status. 


Monitor 


Pause 


To record module activity in the MAT History File, select Monitor from the 
Options menu. Notice that a check mark appears next to Monitor in the menu 
to show that it is active. Click on the menu selection a second time to 
deactivate this feature. 


The MAT History File displays each entry as it arrives and is logged to disk. 
The Monitor process ignores any filters that may be set. 


Select Pause to suspend the monitoring process at the last entry. Click a 
second time to resume monitoring. 
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